---
title: "Container Movement Management System"
space: "Icd tz"
url: "https://support.aakvatech.com/ICD TZ/container-movement-management-system"
updated: "2026-07-22"
---

# User Manual for Container Movement Management System

## 1. Overview
The **Container Movement Management System** is a module within **Frappe ERPNext** designed to track and manage the movement of containers. It allows users to create movement orders, track container status, update movement details, and ensure proper record-keeping of container logistics.

## 2. Key Features
- **Movement Order Creation:** Enables users to initiate container movements.
- **Container Tracking:** Monitors the status of containers from one location to another.
- **Linking with Other Modules:** Integrates with **Manifest, Container Reception, and Inspection** modules.
- **Validation Checks:** Ensures required fields like *Container No, Transporter, and Movement Date* are provided before submission.
- **Role-Based Access:** Controls who can create, modify, and submit movement orders.
- **Container Return Management:** Allows tracking of containers until they return to the depot.

## 3. Pre-Requisites
Before using this module, ensure the following:
- **ERPNext and Frappe Installed** (v13 or above recommended).
- **User Role Permissions Configured** (System Manager, Movement Manager).
- **Container Reception Exists** (Movements should be linked to a received container).
- **Transporters and Vehicles Are Registered** (Ensure all transporters and vehicles are available in the system).

## 4. Step-by-Step Usage
### Step 1: Creating a Container Movement Order
1. Navigate to **Container Movement Order** in ERPNext.
2. Click **New** to create a new order.
3. Fill in the required details:
   - *Container Number, Movement Date, Transporter, Driver, Truck, and Destination.*
4. Click **Save** to store the order.

### Step 2: Submitting the Movement Order
1. Ensure all required fields are filled.
2. Click **Submit** to finalize the movement.
3. The system automatically updates the container’s location.

### Step 3: Updating Movement Details
1. Open an existing **Container Movement Order**.
2. Update relevant fields (e.g., *Arrival Time, Departure Time, or Status*).
3. Click **Save** to record the changes.

### Step 4: Tracking Container Return
1. Open the **Container Movement Order** linked to the container.
2. Update the **Return Date** once the container is back in the yard.
3. Change the **Container Status** to **Returned**.
4. Click **Save** to finalize the update.

## 5. Troubleshooting (Common Errors and Resolutions)
| Error | Cause | Solution |
|-------|-------|----------|
| *Container Number cannot be empty* | Missing required field | Ensure a container is selected before saving |
| *Transporter not assigned* | Data entry missing | Select the appropriate transporter before submitting |
| *Invalid movement date* | Incorrect date format | Enter a valid movement date (YYYY-MM-DD) |
| *Submission restricted* | User lacks permissions | Verify that the user has submission rights under system settings |

## 6. User Roles and Permissions
### Roles Available:
- **System Manager:** Full control (create, edit, delete, submit, and manage movement records).
- **Movement Manager:** Can create, edit, and submit records but cannot delete them.
- **Read-Only Users:** Can view movement details but cannot edit or modify them.

### Permissions Matrix
| Action | System Manager | Movement Manager | Read-Only |
|--------|---------------|-----------------|-----------|
| Create Movement Order | ✅ | ✅ | ❌ |
| Edit Movement Order | ✅ | ✅ | ❌ |
| Submit Movement Order | ✅ | ✅ | ❌ |
| Delete Movement Order | ✅ | ❌ | ❌ |
| View Movement Order | ✅ | ✅ | ✅ |

## 7. Key Notes
- Ensure all **required fields** are filled before saving a movement order.
- The **search function** enables filtering based on *Container Number, Transporter, and Movement Date*.
- Properly link movement records to the relevant **Container Reception** for accurate tracking.
- **Submission workflow** ensures only authorized users can finalize records.

---

This manual serves as a complete guide to managing **Container Movement** records in ERPNext. For further assistance, contact the **System Administrator** or refer to **Frappe Documentation**.